<?xml version="1.0" encoding="UTF-8" standalone="no"?>
<!DOCTYPE html PUBLIC "-//W3C//DTD XHTML 1.0 Transitional//EN" "http://www.w3.org/TR/xhtml1/DTD/xhtml1-transitional.dtd">
<html xmlns="http://www.w3.org/1999/xhtml">
  <head>
    <meta http-equiv="Content-Type" content="text/html; charset=UTF-8" />
    <title>sndinfo</title>
    <link rel="stylesheet" type="text/css" href="csound.css" />
    <meta name="generator" content="DocBook XSL Stylesheets V1.78.1" />
    <link rel="home" href="index.html" title="The Canonical Csound Reference Manual" />
    <link rel="up" href="UtilityQueries.html" title="File Queries (SNDINFO)" />
    <link rel="prev" href="UtilityQueries.html" title="File Queries (SNDINFO)" />
    <link rel="next" href="UtilityConversion.html" title="File Conversion (HET_IMPORT, HET_EXPORT, PVLOOK, PV_EXPORT, PV_IMPORT, SDIF2AD, SRCONV)" />
  </head>
  <body>
    <div class="navheader">
      <table width="100%" summary="Navigation header">
        <tr>
          <th colspan="3" align="center">sndinfo</th>
        </tr>
        <tr>
          <td width="20%" align="left"><a accesskey="p" href="UtilityQueries.html">Prev</a> </td>
          <th width="60%" align="center">File Queries (SNDINFO)</th>
          <td width="20%" align="right"> <a accesskey="n" href="UtilityConversion.html">Next</a></td>
        </tr>
      </table>
      <hr />
    </div>
    <div class="refentry">
      <a id="sndinfo"></a>
      <div class="titlepage"></div>
      <div class="refnamediv">
        <h2>
          <span class="refentrytitle">sndinfo</span>
        </h2>
        <p>sndinfo — 
      Displays information about a soundfile.
      <a id="IndexSndinfo" class="indexterm"></a>
    </p>
      </div>
      <div class="refsect1">
        <a id="idp222774720"></a>
        <h2>Description</h2>
        <p>
      Get basic information about one or more soundfiles.
    </p>
      </div>
      <div class="refsect1">
        <a id="idp222775872"></a>
        <h2>Syntax</h2>
        <pre class="synopsis"><span class="command"><strong>csound -U sndinfo</strong></span> [options] soundfilenames ...</pre>
        <pre class="synopsis"><span class="command"><strong>sndinfo</strong></span> [options] soundfilenames ...</pre>
      </div>
      <div class="refsect1">
        <a id="idp222779136"></a>
        <h2>Initialization</h2>
        <p>
      <span class="emphasis"><em>sndinfo</em></span> will attempt to find each named
    file, open it for reading, read in the soundfile header, then
    print a report on the basic information it finds. The order of
    search across soundfile directories is as described <a class="link" href="UtilityTop.html#UtilityDir" title="Directories.">above</a>. If the
    file is of type AIFF, some further details are listed first. 
    </p>
        <p>
      There are two option types:
      </p>
        <div class="orderedlist">
          <ol class="orderedlist" type="1">
            <li class="listitem">
              <p><span class="emphasis"><em>-i</em></span> or <span class="emphasis"><em>-i1</em></span> will print instrument information, which includes looping. The option continues until a <span class="emphasis"><em>-i0</em></span> option.</p>
            </li>
            <li class="listitem">
              <p>The other option is <span class="emphasis"><em>-b</em></span> which prints the broadcast information for WAV files.  It can similarly be negated with <span class="emphasis"><em>-b0</em></span>.</p>
            </li>
          </ol>
        </div>
        <p>
    </p>
      </div>
      <div class="refsect1">
        <a id="idp222787120"></a>
        <h2>Examples</h2>
        <p>

        </p>
        <pre class="programlisting">
<span class="emphasis"><em>csound -U sndinfo</em></span> test Bosendorfer/"BOSEN mf A0 st" foo foo2</pre>
        <p>


      where the environment variables SFDIR = /u/bv/sound, and SSDIR = /so/bv/Samples, might produce the following:


        </p>
        <pre class="programlisting">
util  SNDINFO:      
     /u/bv/sound/test:
           srate 22050, monaural, 16 bit shorts, 1.10 seconds
           headersiz 1024, datasiz 48500  (24250 sample frames)
  
    /so/bv/Samples/Bosendorfer/BOSEN mf A0 st:  AIFF, 197586 stereo samples, base Frq 261.6 (MIDI 60), sustnLp: mode 1, 121642 to 197454, relesLp: mode 0
     AIFF soundfile, looping with modes 1, 0
     srate 44100, stereo, 16 bit shorts, 4.48 seconds
  
     headersiz  402, datasiz 790344  (197586 sample frames)
  
     /u/bv/sound/foo:
           no recognizable soundfile header
  
     /u/bv/sound/foo2:
            couldn't find</pre>
        <p>

    </p>
      </div>
    </div>
    <div class="navfooter">
      <hr />
      <table width="100%" summary="Navigation footer">
        <tr>
          <td width="40%" align="left"><a accesskey="p" href="UtilityQueries.html">Prev</a> </td>
          <td width="20%" align="center">
            <a accesskey="u" href="UtilityQueries.html">Up</a>
          </td>
          <td width="40%" align="right"> <a accesskey="n" href="UtilityConversion.html">Next</a></td>
        </tr>
        <tr>
          <td width="40%" align="left" valign="top">File Queries (SNDINFO) </td>
          <td width="20%" align="center">
            <a accesskey="h" href="index.html">Home</a>
          </td>
          <td width="40%" align="right" valign="top"> File Conversion (HET_IMPORT, HET_EXPORT, PVLOOK, PV_EXPORT, PV_IMPORT, SDIF2AD, SRCONV)</td>
        </tr>
      </table>
    </div>
  </body>
</html>
